Hexo博客搭建系列 No.3 搭建Hexo博客 基础写作与管理 MarKdown

1. 配置文章模版

/scaffolds目录下有几个模版文件,其中

post.md:新建博文模版
page.md:新建标签页模版

post.md模版,仅供参考

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
---
title: {{ title }} #【必需】页面标题
date: {{ date }} #【必需】页面创建日期
updated: #【可选】页面更新日期
tags: #【可选】文章标签
categories: #【可选】文章分类
keywords: #【可选】文章关键字
description: #【可选】文章描述
top: # 1 置顶
top_img: #【可选】文章顶部图片
comments: #【可选】显示文章评论模块(默认 true)
cover: https://imgs.187322.xyz/file/**********.png #【可选】文章缩略图(如果没有设置 top_img,文章页顶部将显示缩略图,可设为 false/图片地址/留空)
toc: #【可选】显示文章 TOC(默认为设置中 toc 的 enable 配置)
toc_number: #【可选】显示 toc_number(默认为设置中 toc 的 number 配置)
toc_style_simple: #【可选】显示 toc 简洁模式
copyright: #【可选】显示文章版权模块(默认为设置中 post_copyright 的 enable 配置)
copyright_author: #【可选】文章版权模块的文章作者
copyright_author_href: #【可选】文章版权模块的文章作者链接
copyright_url: #【可选】文章版权模块的文章作者链接
copyright_info: #【可选】文章版权模块的版权声明文字
mathjax: #【可选】显示 mathjax(当设置 mathjax 的 per_page: false 时,才需要配置,默认 false)
katex: #【可选】显示 katex(当设置 katex 的 per_page: false 时,才需要配置,默认 false)
aplayer: #【可选】在需要的页面加载 aplayer 的 js 和 css,请参考文章下面的音乐 配置
highlight_shrink: #【可选】配置代码框是否展开(true/false)(默认为设置中 highlight_shrink 的配置)
aside: #【可选】显示侧边栏 (默认 true)
swiper_index: 10 #【可选】首页轮播图配置 index 索引,数字越小越靠前
top_group_index: 10 #【可选】首页右侧卡片组配置, 数字越小越靠前
ai: #【可选】文章ai摘要
background: "#fff" #【可选】文章主色,必须是16进制颜色且有6位,不可缩减,例如#ffffff 不可写成#fff
---

<div class="video-container">
[up主专用,视频内嵌代码贴在这]
</div>

<style>
.video-container {
position: relative;
width: 100%;
padding-top: 56.25%; /* 16:9 aspect ratio (height/width = 9/16 * 100%) */
}

.video-container iframe {
position: absolute;
top: 0;
left: 0;
width: 100%;
height: 100%;
}
</style>

page.md模版,仅供参考

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
---
title: {{ title }} #【必需】页面标题
date: {{ date }} #【必需】页面创建日期
type: #【必需】标签、分类、关于、音乐馆、友情链接、相册、相册详情、朋友圈、即刻页面需要配置
updated: #【可选】页面更新日期
comments: #【可选】显示页面评论模块(默认 true)
description: #【可选】页面描述
keywords: #【可选】页面关键字
top_img: https://img.090227.xyz/file/ae62475a131f3734a201c.png #【可选】页面顶部图片
mathjax: #【可选】显示 mathjax(当设置 mathjax 的 per_page: false 时,才需要配置,默认 false)
katex: #【可选】显示 katex(当设置 katex 的 per_page: false 时,才需要配置,默认 false)
aside: #【可选】显示侧边栏 (默认 true)
aplayer: #【可选】在需要的页面加载 aplayer 的 js 和 css,请参考文章下面的音乐 配置
highlight_shrink: #【可选】配置代码框是否展开(true/false)(默认为设置中 highlight_shrink 的配置)
top_single_background: #【可选】部分页面的顶部模块背景图片
---


更多功能

新建文章

新建博文命令

1
hexo new 这是一篇新的博文

新建标签页命令

1
hexo new page 新建的标签页

文章置顶

安装插件

1
npm install hexo-generator-topindex --save

设置置顶

  • 给需要置顶的文章加入top参数,如下:
1
2
3
4
5
6
7
8
9
---
title: 每天一个linux命令
date: 2017-01-23 11:41:48
top: 1
categories:
- 运维
tags:
- linux命令
---
  • 如果存在多个置顶文章,top后的参数越大,越靠前。

开启本地搜索

安装插件

1
npm install hexo-generator-search --save
  • 设置主题配置文件
1
2
3
4
local_search:
enable: true
preload: false
CDN:
参数 类型 必需/可选 默认值 说明
enable boolean 可选 false 是否开启本地搜索功能
preload boolean 可选 false 是否预加载搜索文件。开启时网页加载后自动加载搜索文件;关闭时点击搜索按钮后才加载
CDN string/array 可选 - 搜索文件的CDN地址。如果配置,将使用CDN链接;不配置则使用本地链接

添加任意文件

  • 例如当我们想在网站根目录添加ads.txt文件,来通过站长验证时,我们只需要在/source文件夹下放置该文件即可。

参考资料

https://docs.anheyu.com/initall.html
https://www.fomal.cc/posts/4aa2d85f.html
https://github.com/anzhiyu-c/hexo-theme-anzhiyu/blob/dev/README.md?plain=1
https://blog.csdn.net/COCO56/article/details/103840966

📚 Hexo博客搭建与主题美化教程导航

  1. Hexo博客搭建系列 No.0 Spaceship.com域名购买完整指南 - Spaceship.com - 从注册到配置全解析
  2. Hexo博客搭建系列 No.0 阿里云域名购买完整指南 - 阿里云域名购买完整指南 - 从注册到配置全解析
  3. Hexo博客搭建系列 No.0 腾讯云域名购买完整指南 - 腾讯云域名购买完整指南 - 从注册到配置全解析
  4. Hexo博客搭建系列 No.1 搭建Hexo博客 - 环境配置与安装
  5. Hexo博客搭建系列 No.2 搭建Hexo博客 - 主题配置与部署
  6. Hexo博客搭建系列 No.3 搭建Hexo博客 - 基础写作与管理 ✨ 当前教程
  7. Hexo博客搭建美化系列 No.1 搭建Hexo博客 - 敬请期待
  8. Hexo博客搭建美化系列 No.2 搭建Hexo博客 - 敬请期待
  9. Hexo博客搭建美化系列 No.3 搭建Hexo博客 - 敬请期待
  10. Hexo博客搭建美化系列 No.4 搭建Hexo博客 - 敬请期待
  11. Hexo博客搭建美化系列 No.5 搭建Hexo博客 - 敬请期待
  12. Hexo博客搭建美化系列 No.6 搭建Hexo博客 - 敬请期待
  13. Hexo博客搭建美化系列 No.7 搭建Hexo博客 - 敬请期待
  14. Hexo博客搭建美化系列 No.8 搭建Hexo博客 - 敬请期待
  15. Hexo博客搭建美化系列 No.9 搭建Hexo博客 - 敬请期待
  16. Hexo博客搭建美化系列 No.10 搭建Hexo博客 - 敬请期待
  17. Hexo博客搭建美化系列 No.11 搭建Hexo博客 - 敬请期待
  18. Hexo博客搭建美化系列 No.12 搭建Hexo博客 - 敬请期待